/status/system/interface/<intf_name>/channelPorts/<member_intf_name>/reason¶
</member_intf_name>
Use
Use to view the why the port is in its current state.
Parameters¶
intf_name: Name of port channel interface
member_intf_name: Name of interface that is a member of the port channel
Data Key¶
The data key contains one of the values in Data Values below.
Note: When the default key is set to true, it means the object is set to its default. In this case, the system works as follows:
- On a PUT operation, the system ignores the data key. (Applicable only to /config nodes.)
- On a GET operation, the response only contains “default”: True and does not contain the data key.
- If the object has a base, it inherits its setting from its base.
See [Setting Objects to Their Default](https://docs.lineratesystems.com/093Rel ease_2.5/250REST_API_Reference_Guide/000Getting_Started_with_the_REST_API/300U nderstanding_the_REST_Hierarchy#Setting_Objects_to_Their_Default_(Default_Key) ).
Data Type¶
string
Data Values¶
Unset
The port channel’s mode has not been set or does not match the rest of the interfaces in the port channel.
Static
The port channel’s mode is set to “on.”
LACP
The port channel’s mode is set to “active,” which means it is using LACP.
Admin Status Up or Admin Status Down
The port channel’s admin status is set to online or offline.
Link Protocol Up or Link Protocol Down
The connection to the port channel is not working for some hardware reason (cable disconnected, failed interface, etc.).
Unknown
The system cannot determine the status of the port channel.
Default Data Value¶
“”
An object uses the default data value when one of the following is true:
- For objects without bases–When the object’s default key is true.
- For objects with bases–When the object’s default key is true, and when the default key is true for all of the object’s bases.
Request Methods¶
GET
Examples¶
GET
curl -b cookie.jar -k https://host-43:8443/lrs/api/v1.0/status/system/interfac e/name/channelPorts/name/reason
GET Response
{"httpResponseCode": 404,
"internalResponseCode": 101,
"message": "Request failed: Unable to retrieve data from controller\n Path: /system/interface/name/channelPorts/name/reason\n ResponseCode: 101 (Path not found)\n",
"recurse": False,
"requestPath": "/status/system/interface/name/channelPorts/name/reason"}
- /status/system/interface/<intf_name>/channelPorts/<member_intf_name>/reason</member_intf_name>
1. Parameters
2. Data Key
- Data Type
- Data Values
- Default Data Value 3. Request Methods 4. Related 5. Examples